PATH 
Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference

     

ATSUGetFontFeatureNameCode

Obtains information about the name code of a feature type or selector in a font feature.

OSStatus ATSUGetFontFeatureNameCode (
                     ATSUFontID iFont,
                     ATSUFontFeatureType iType,
                     ATSUFontFeatureSelector iSelector,
                     FontNameCode *oNameCode);
iFont
A value of type ATSUFontID. Pass the ID of the font whose feature type or selector you want to determine the name code for.

iType
A value of type ATSUFontFeatureType. Pass a valid feature type whose name code you want to obtain.

iSelector
A value of type ATSUFontFeatureSelector. Pass the feature selector whose name code you want to obtain. If you pass the constant kATSUNoSelector, the value passed back in the oNameCode parameter represents the name code of the feature type itself.

oNameCode
A pointer to a value of type FontNameCode. On return, the type of the feature type or selector name, depending upon the value passed in the iSelector parameter. See Font Name Code Constants for a description of possible values. You cannot pass NULL for this parameter.

function result
A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to any installed font. The result code kATSUNotSetErr indicates that the font has no name in its name table for the indicated font feature. For a list of other ATSUI-specific result codes, see Result Codes.
DISCUSSION
By default, the ATSUGetFontFeatureNameCode function obtains the name code of the specified feature selector. If you pass the constant kATSUNoSelector in the iSelector parameter, ATSUGetFontFeatureNameCode obtains the name code of the feature type. You can pass this value to the function ATSUFindFontName to find the localized feature selector or feature type name identified by this name code.

VERSION NOTES
Available beginning with ATSUI 1.0.


© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)